Skip to content

Kategorien: Kontonummer auch in Kontakthistorie und Vorschlagskarte (#1438) - #1501

Open
JB1985 wants to merge 3 commits into
firsttris:mainfrom
JB1985:kontonummern-folge
Open

JB1985 wants to merge 3 commits into
firsttris:mainfrom
JB1985:kontonummern-folge

Conversation

@JB1985

@JB1985 JB1985 commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Refs #1438

Folge-PR zu #1455, wie dort mit dem Maintainer besprochen: Die Kontakthistorie und die Vorschlagskarte im Zuordnungsdialog nennen bei Ausgaben die Nummer des Kontos im Kontenrahmen der Firma vor der Bezeichnung („Ausgabe: 4920 · Telefon“ in SKR03, „6805 · Telefon“ in SKR04). Gespeichert und gebucht wird weiter die Kategorie; Buchungstexte, Journal, EÜR und DATEV-Export bleiben unverändert.

Was sich ändert

  • Kontakthistorie: Die Spalte „Art“ der Belege eines Lieferanten zeigt die Kategorie mit Nummer (belegArt mit kategorieMitKonto, wie die Belegliste). Der Kontenrahmen kommt aus dem App-Kontext.
  • Vorschlagskarte: vorschlagTitel nimmt den Kontenrahmen und bildet den Titel mit kategorieAnzeige; Einnahmen („Einnahme: Erlöse 19 %“) und Anlagegut bleiben ohne Nummer, wie in Kategorien: Kontonummer vor der Bezeichnung, Direkt buchen als Suchfeld (#1438) #1455.
  • Tests und Doku: DirektVorschlag.test.ts mit Nummer, neu ein Fall für SKR04; docs/bank.md und docs/kontakte.md nennen die Nummer; die E2E-Erwartung „Ausgabe: Telefon“ in belege-steuern.spec.ts lautet jetzt mit Nummer.

Geprüft

  • Biome und Typecheck sauber; bun scripts/dateigroesse/pruefen.ts ohne Befund.
  • Vitest: DirektVorschlag.test.ts und neu ContactHistoryArt.test.ts (die Spalte „Art“ des Belegs als reine Funktion belegArt, SKR03 und SKR04, Anlagegut und unbekannter Wert ohne Nummer, Aufteilung); Komponenten und kontakt-historie.test.ts, 41 Dateien, 245 Tests grün, dazu die drei neuen.
  • E2E (Produktionsbuild, Stand vor der Auslagerung von belegArt): belege-steuern.spec.ts, 110 Tests grün, darunter die Karte „Ausgabe: … Telefon“.
  • Aus der laufenden App: Kontakthistorie eines Lieferanten und Vorschlagskarte in Hell und Dunkel (Bilder unten).

Übersprungen: Nicht gelaufen sind die übrigen E2E-Dateien (die Kontaktseite zeigt in ihnen keine Kategorie) und die Postgres-Tests des Moduls Bank. Die Kontakthistorie hat keinen E2E-Test mit Kategorie.

Bilder

Gleiche Testdaten vorher (main mit #1455) und nachher, Desktop. Am Handy ist die Spalte „Art“ der Kontakthistorie ausgeblendet, dort ändert sich nichts. Die Bilder liegen im Fork JB1985/haben-bilder; mit dem Fork verschwinden sie.

Kontakthistorie eines Lieferanten, Spalte „Art“:

Vorher Nachher
Hell
Dunkel

Bank, Vorschlagskarte im Zuordnungsdialog:

Vorher Nachher
Hell
Dunkel

🤖 Generated with Claude Code

JB1985 and others added 2 commits November 19, 2026 09:38
…irsttris#1438)

Die Spalte „Art“ der Kontakthistorie (Lieferant) und der Titel der Vorschlagskarte im
Zuordnungsdialog nennen bei Ausgaben die Nummer des Kontos im Kontenrahmen der Firma
(„Ausgabe: 4920 · Telefon“). Einnahmen und Anlagegut bleiben ohne Nummer, Buchungstexte
und gespeicherte Werte unverändert.

Refs firsttris#1438

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…est (firsttris#1438)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@JB1985

JB1985 commented Nov 19, 2026

Copy link
Copy Markdown
Contributor Author

Selbstprüfung (beitrag-pruefen)

Stand: be3092e, geprüft in einem frischen Agenten ohne den Verlauf der Entstehung (nur gelesen, keine Tests ausgeführt)

Wollen wir das?

Vollständig

Akzeptanzkriterium (Folge-PR laut #1455, Antwort 3) Ergebnis Datei oder Test
Kontakthistorie (Spalte „Art“) mit Nummer erfüllt ContactHistory.tsx:166,181,219-222; kein Test (siehe Regeln)
Vorschlagskarte mit Nummer, Einnahmen und Anlagegut ohne erfüllt DirektVorschlag.ts:10-13, DirektVorschlag.test.ts:16-21 (SKR03 und SKR04)
Text in docs/bank.md und docs/kontakte.md erfüllt bank.md:366, kontakte.md:69
E2E-Erwartung „Ausgabe: Telefon“ erfüllt belege-steuern.spec.ts:3049

Refs #1438 stimmt. Ob #1438 damit fertig ist (Erlöse am Steuersatz und „Eigenes Konto“ hat der Maintainer in #1455 offen bzw. „so lassen“ beantwortet), entscheidet der Maintainer: Frage unten.

Quellen und fachlich

Heikel: nein. Keine neue fachliche Aussage. Die Nummer kommt aus EXPENSE_CATEGORIES[k][kontenrahmen], derselben Tabelle wie die Buchung (in #1455 vom Maintainer nachgeprüft); kategorieMitKonto lässt „Anlagegut“ ohne Nummer (kontenplan.ts:222-223), unbekannte Werte unverändert (:219). Randfälle in den Aufrufen: Einnahmen bleiben ohne Nummer (direkt-kategorie.ts:187), Aufladung nennt weiter ihre Art (DirektVorschlag.ts:11).

Einfachste Lösung?

Ja im Kern: keine neue Logik, nur die vorhandenen Bausteine an zwei weiteren Stellen. Ein Vorschlag, kein Fehler: ContactHistory ist eine Komponente unter components/ und holt den Kontenrahmen mit getRouteApi("/_app") selbst (ContactHistory.tsx:166). Sonst nutzt keine Komponente in components/ getRouteApi; die Route kontakte/$id.tsx, die ContactHistory einbindet (:143), könnte den Kontenrahmen als Prop geben. Dann wäre Entries auch ohne Router-Kontext testbar. Das ist eine Frage der Form; nur der fehlende Test unten ist ein Befund.

Regeln

Regel Ergebnis Stelle
Tests: zu jeder geänderten Funktion ein Test (docs/mitwirken.md, Beiträge annehmen) ✗ ContactHistory.tsx:219 entryKind ist geändert und hat keinen Test. Die Begründung der Beschreibung („ein Komponententest bräuchte den Router-Kontext“) trägt nicht: entryKind(row, kontenrahmen) ist jetzt eine reine Funktion mit dem Kontenrahmen als Parameter; exportiert und getestet (SKR03/SKR04, Anlagegut, unbekannter Wert, Aufteilung, Rechnung/Archiv) braucht sie keinen Router. Andere Komponententests importieren auch aus .tsx (z. B. AnlageN.test.ts). Vorbehalt: nicht ausgeführt, ob der Import von altbestand.ts im Vitest-Lauf ohne Browser geht.
Screenshots vorher und nachher, hell und dunkel (docs/mitwirken.md, Zeile 30, „Änderungen am Aussehen“) ✗, siehe unten Beschreibung: „Bilder liefere ich auf Wunsch nach“
Keine Tests geschwächt ✓ DirektVorschlag.test.ts: Erwartung nur um die Nummer ergänzt, Aufrufe um "SKR03"; E2E-Regex [0-9]{4} folgt dem Helfer apps/web/e2e/kategorie.ts (Nummer je Kontenrahmen), der Wert selbst ist im Unit-Test exakt geprüft
Doku ✓ bank.md:366, kontakte.md:69 stimmen mit dem Code; belege.md:239 nennt die Nummer schon
DESIGN.md ✓ betrifft nicht keine Regel dort zur Kontakthistorie oder Vorschlagskarte (grep nach Kontakthistorie, Vorschlagskarte, match-card, CategoryCombobox: nur Zeile 210 zu <select>, nicht berührt)
Geld, GoBD, Migration, Pakete, Länge betrifft nicht keine Beträge, keine Migration, keine Funktion über 80 Zeilen im Diff
Pull Request ✓ Titel Bereich: … (#1438), Refs, Beschreibung nennt Änderung, Geprüftes und Übersprungenes, KI-Kennzeichnung, Entwurf
CI nicht beurteilbar Auf dem Kopf-Commit sind alle CI-Jobs übersprungen (Entwurf), pr-regeln, build und board stehen in der Warteschlange

Zu den Bildern (ehrlich): Die Begründung „nur Text in zwei Zeilen, kein Layout“ trägt nach den Regeln nicht ganz.

  • docs/mitwirken.md:30 kennt keine Ausnahme für reine Textänderungen; es nennt „Änderungen am Aussehen“, und was ein Nutzer in der Oberfläche liest, gehört dazu. DESIGN.md regelt es nicht anders.
  • Der Maintainer hat für dieselbe Änderung in Kategorien: Kontonummer vor der Bezeichnung, Direkt buchen als Suchfeld (#1438) #1455 Bilder verlangt, ausdrücklich „weil sich die Oberfläche ändert (Kontonummer vor der Bezeichnung)“, und danach für gut befunden.
  • „Auf Wunsch nachliefern“ dreht die Regel um: Die Bilder gehören in die Beschreibung.
  • Es gibt einen sachlichen Grund, hinzusehen: Die Spalte „Art“ ist minmax(0, 1.2fr) mit ellipsis (kontakte.css:5, ContactHistory.tsx:181), der Text wird um „NNNN · “ länger; ein langer Name wie „Software und Lizenzen“ kann abgeschnitten werden. Am Handy (unter 760px) ist die Spalte ausgeblendet (kontakte.css:14), dort ändert sich nichts.
  • Maß: je ein Paar vorher/nachher für die Kontakthistorie eines Lieferanten und für die Vorschlagskarte, hell und dunkel; Handy für die Karte nur, wenn es nicht passt. Das ist wenig Aufwand, die Regel gilt trotzdem.

Ob der Maintainer hier darauf verzichtet, entscheidet er (Frage unten); der Beitragende nicht.

Offene Fragen an den Maintainer

Nachtrag: nachgebessert bis 981b8df

  • Test für die Spalte „Art“ (Regeln, ✗): entryKind ist nicht exportierbar testbar, weil ContactHistory.tsx Server-Module mitlädt (der Import brach im Test mit einem ZodError ab). Der Beleg-Teil liegt deshalb in ContactHistoryArt.ts (belegArt); neu ContactHistoryArt.test.ts mit SKR03, SKR04, Anlagegut und unbekanntem Wert ohne Nummer, Aufteilung und ohne Kategorie (981b8df). Den Kontenrahmen holt Entries weiter aus dem App-Kontext; ein Prop aus kontakte/$id.tsx ist damit für die Testbarkeit nicht mehr nötig.
  • Bilder (Regeln, ✗): Vorher (main mit Kategorien: Kontonummer vor der Bezeichnung, Direkt buchen als Suchfeld (#1438) #1455) und nachher mit denselben Testdaten, hell und dunkel, für die Kontakthistorie eines Lieferanten und die Vorschlagskarte, in der Beschreibung (Fork JB1985/haben-bilder). „Auf Wunsch nachliefern“ ist gestrichen. In der Kontakthistorie wird nichts abgeschnitten; am Handy ist die Spalte ausgeblendet.
  • Beschreibung nachgezogen: neuer Test, Bilder, Stand der E2E-Läufe.

Selbstprüfung mit Claude Code erzeugt

…is#1438)

Bei einem Beleg mit eigenem Konto bucht Haben dort, die Spalte „Art“ zeigt wie die
Kategorieauswahl die Nummer des Standardkontos; das Anlagegut steht ohne Nummer.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@JB1985

JB1985 commented Nov 19, 2026

Copy link
Copy Markdown
Contributor Author

tdd-review

Stand: 981b8df, geprüft von einem unabhängigen, frischen Agenten ohne den Verlauf der Entstehung

Geprüft

  • Diff (gh pr diff 1501), Kontext im Klon auf 981b8df9, Konfliktfreiheit nicht eigens geprüft (CI).
  • Tests auf jaba-runner, Worktree ~/haben-1438-folge (Stand 981b8df, unverändert), Wegwerf-Datenbank haben_review_1501_test (danach gelöscht): bun --bun vitest run apps/web/src/components/ContactHistoryArt.test.ts apps/web/src/components/DirektVorschlag.test.ts packages/core/src/direkt-kategorie.test.ts packages/core/src/posting.test.ts → 4 Dateien, 102 Tests grün.
  • Nummer gegen die Buchung: kategorieMitKonto (packages/core/src/kontenplan.ts:218) liest dieselbe Tabelle EXPENSE_CATEGORIES wie die Buchung (telefon SKR03 4920, SKR04 6805, Zeile 167). SKR03/SKR04 stimmen, anlage bleibt ohne Nummer, unbekannte Werte aus Importen kommen über Object.hasOwn unverändert durch.
  • Vorschlagskarte: kategorieAnzeige (direkt-kategorie.ts:186) setzt die Nummer nur bei Ausgaben, Einnahmen bleiben „Erlöse 19 %“ (kategorieText), die Aufladung trägt weiter „Aufladung Guthaben“ vor allem anderen. Buchungstexte (bank/direkt-kategorie.ts:54, 80) nutzen weiter kategorieText, gespeichert und gebucht ist nichts geändert, der PR berührt nur Oberfläche und Doku.
  • Kontenrahmen im Kontext: kontenrahmen kommt aus _app.tsx:29 (?? "SKR03"). ContactHistory hängt nur an routes/_app/kontakte/$id.tsx, DirektVorschlagKarte nur an _app/-bank-zuordnung.tsx; beide liegen unter /_app. Außerhalb davon (Seiten wie /login, /setup) werden sie nicht gerendert. Kein Test rendert die Komponenten (grep in apps/web/src und e2e: nur die reinen Funktionen belegArt und vorschlagTitel werden getestet), also fehlt der Kontext dort nirgends. getRouteApi("/_app") im Modulkopf entspricht dem bestehenden Muster (-bank-zuordnung-zustand.ts:19).
  • Verworfen: die Karte zeigt bei Einnahmen und unbekannten Kategorien kein Konto; das ist so gewollt und stimmt mit „Einnahmen bleiben ohne“ in kategorienMitKonto überein.

Befunde (vor dem Merge nötig)

Keine mit rotem Test belegt.

Vorschlag (kein roter Test, aus dem Code belegt)

  1. Kontakthistorie nennt bei einem Beleg mit eigenem Sachkonto die Nummer der Kategorie, nicht des Kontos, auf das gebucht wurde.
    • Beleg mit ownAccountId (Eigene Sachkonten anlegen und bei Eingangsbelegen auswählen #270) bucht „dort statt auf das Konto der Kategorie“ (apps/web/src/server/modules/belege/belegbuchung.ts:68–71, category bleibt die Elternkategorie, schema.ts:2136).
    • supplierDocuments (modules/belege/lieferant-belege.ts:12–23) liefert ownAccountId nicht, ContactHistoryRow und belegArt(beleg: { category; splitCount }, …) (ContactHistoryArt.ts:8) kennen es nicht. Ein Beleg auf das eigene Konto 4921 „Eigene Software“ (Elternkategorie software) steht also als „4920 · Software“ in der Spalte „Art“, gebucht ist er auf 4921.
    • Die Belegliste zeigt es richtig: Kategorie mit Nummer und darunter das eigene Konto (routes/_app/belege/index.tsx:182, documents.ts:876). Die Kontakthistorie bietet diese Zeile nicht.
    • Kein roter Test, weil belegArt den Fall mit seiner Signatur nicht ausdrücken kann; der Test wäre erst nach Erweiterung von supplierDocuments/belegArt möglich. Vorschlag: ownAccountId (oder die Nummer) mitliefern und wie in der Belegliste anzeigen, oder in der Spalte bewusst die Kategorie meinen und das in docs/kontakte.md sagen. Nach Behauptung im PR („Nummer ihres Kontos“) stimmt der Text sonst nicht.
  2. E2E prüft die Nummer nur als Form. belege-steuern.spec.ts:3049 erwartet /Ausgabe: [0-9]{4} · Telefon/; ein falscher Kontenrahmen im Kontext (SKR04 statt SKR03) bliebe grün. Die Prüfung von SKR03 und SKR04 liegt in DirektVorschlag.test.ts (SKR03 und SKR04), dort aber ohne den Weg über den Router-Kontext. Die Doku nennt „4920“ (SKR03); die Zahl ließe sich im E2E mit dem Kontenrahmen der Test-Firma fest erwarten.
  3. Kein Test für die Kontakthistorie in der Oberfläche. ContactHistoryArt.test.ts bildet nur belegArt ab (drei Tests, gut gewählte Randfälle: SKR03/SKR04, Anlagegut, Import-Wert, Aufteilung, leer). Die Verdrahtung getRouteApi("/_app").useRouteContext() in ContactHistory.tsx:167 ist nirgends getestet. Die Erwartungen in den Tests (4920, 6805) sind in der Tabelle EXPENSE_CATEGORIES fest verdrahtet und damit Abbild der Daten, ändert jemand die Tabelle, schlägt der Test an; das ist hier gewollt und kein Mangel.

Nicht geprüft

  • Lint, Typecheck, E2E, Doku-Build (laufen in der CI). Doku nur gelesen (docs/bank.md, docs/kontakte.md), doku-pruefen nicht ausgeführt; der PR ändert Code und Markdown, dafür wäre der Skill doku-pruefen zusätzlich zu starten.
  • Klick-Test im Browser.
  • Eigene Sachkonten in der Vorschlagskarte: KategorieWahl und bank/direkt-kategorie.ts kennen keine, daher dort kein Befund.

Nachtrag: bis 1125092

  • 1. Eigenes Konto in der Kontakthistorie → bewusst wie in Kategorien: Kontonummer vor der Bezeichnung, Direkt buchen als Suchfeld (#1438) #1455 entschieden: Die Auswahl zeigt das Standardkonto der Kategorie, das eigene Konto steht an Beleg und Belegliste. docs/kontakte.md sagt es jetzt so: „Nummer ihres Standardkontos (beim Anlagegut ohne Nummer)“ (1125092). Ob die Kontakthistorie das eigene Konto zeigen soll, ist ein möglicher kleiner Folgeschritt; Frage an den Maintainer.
  • 2. E2E prüft die Nummer nur als Form → nicht in diesem Pull Request: Der Helfer e2e/kategorie.ts nimmt dieselbe Form ([0-9]{4}), der genaue Wert steht im Unit-Test für SKR03 und SKR04.
  • 3. Verdrahtung der Kontakthistorie nicht getestet → nicht in diesem Pull Request: Ein Komponententest bräuchte den Router-Kontext; die Nummer selbst ist über belegArt getestet.

tdd-review von einem frischen Agenten mit Claude Code erzeugt

@JB1985

JB1985 commented Nov 19, 2026

Copy link
Copy Markdown
Contributor Author

doku-pruefen

Stand: 981b8df, geprüft von einem unabhängigen, frischen Agenten ohne den Verlauf der Entstehung (nur Lesen).

Geprüft

  • Diff der Markdown-Dateien: docs/bank.md (Zeile 366) und docs/kontakte.md (Zeile 69); daneben Code, Tests und E2E-Änderung des PR als Beleg.
  • Jede neue Aussage gegen den Code des Branches; Stil nach docs/entwicklung.md („Kurz halten“); Schreibweise gegen die Nachbarsätze; Links; description: und mkdocs.yml.
  • git grep über alle *.md nach „Ausgabe: “, „Einnahme: “, „Karte nennt“, „Spalte „Art““, „Kontakthistorie“, „Ausgaben und Belege“, „4920“, „6805“.

Stimmt mit dem Code

  • „Ausgabe: 4920 · Telefon“ (SKR03) und „6805 · Telefon“ (SKR04): packages/core/src/kontenplan.ts:167 (telefon: SKR03 "4920", SKR04 "6805"); vorschlagTitel baut „Ausgabe: …“ mit kategorieAnzeige (apps/web/src/components/DirektVorschlag.ts:13), das bei Ausgaben kategorieMitKonto nutzt (packages/core/src/direkt-kategorie.ts:186-187, Format ${Nummer} · ${Bezeichnung} in kontenplan.ts). Tests: DirektVorschlag.test.ts.
  • „Einnahme: Erlöse 7 %“ bleibt ohne Nummer: kategorieAnzeige nimmt für Einnahmen kategorieText (direkt-kategorie.ts:187, Test direkt-kategorie.test.ts:234).
  • „Aufladung Guthaben“ unverändert (AUFLADUNG.text, direkt-kategorie.ts:166; vorschlagTitel gibt ihn vor der Kategorie zurück).
  • Kontakthistorie: Die Spalte „Art“ eines Belegs zeigt belegArt (ContactHistory.tsx, entryKind; ContactHistoryArt.ts:8) mit Kategorie und Kontonummer; „Aufgeteilt auf n Zeilen“ und „–“ wie zuvor. Rechnungen und Archiveinträge der Liste haben ihre eigenen Texte, die Aussage in kontakte.md betrifft nur die Belege des Lieferanten und das trifft zu.
  • Keine andere Seite beschreibt die Vorschlagskarte („Ausgabe: …“) oder die Spalte „Art“ der Kontakthistorie mit altem Wortlaut; die Nachbarseiten docs/belege.md:239, docs/belege.md:521 und docs/bank.md:419 (aus Kategorien: Kontonummer vor der Bezeichnung, Direkt buchen als Suchfeld (#1438) #1455) nennen die Nummer bereits.
  • Stil: Beide Änderungen sind kurze Einschübe, ohne Wiederholung, Ankündigung oder Zusammenfassung. Schreibweise („…“, SKR03/SKR04, „Nummer des Kontos“) wie in belege.md und bank.md. Keine neue Seite, keine Links geändert, description: und mkdocs.yml bleiben unverändert richtig.

Befunde (vor dem Merge nötig)

Keine.

Vorschlag (nicht nötig)

  • docs/kontakte.md:69: „mit der Kategorie und der Nummer ihres Kontos“ gilt nicht ohne Ausnahme: Beim Anlagegut und bei unbekannten Werten aus einem Import steht keine Nummer (kontenplan.ts, kategorieMitKonto; Test ContactHistoryArt.test.ts). docs/belege.md:239 nennt die Ausnahme für das Anlagegut. Wer es genau will, ergänzt „(Anlagegut ohne Nummer)“; kurz halten spricht dafür, es so zu lassen, weil die Ausnahme auf belege.md steht und für einen Lieferantenkontakt selten ist.

Nachtrag: bis 1125092

  • Vorschlag zu docs/kontakte.md:69 → übernommen: „der Nummer ihres Standardkontos (beim Anlagegut ohne Nummer)“; das deckt auch den Hinweis des Code-Reviews zum eigenen Konto am Beleg (1125092).

doku-pruefen von einem frischen Agenten mit Claude Code erzeugt

@JB1985
JB1985 marked this pull request as ready for review November 19, 2026 11:08
@github-actions

Copy link
Copy Markdown
Contributor

PR-Regeln

Hinweise (der Check bleibt grün, bitte trotzdem ansehen):

  • Vor dem Merge: Selbstprüfung mit beitrag-pruefen als Kommentar im Pull Request, dann ein unabhängiges Review mit tdd-review für den Code und parallel doku-pruefen für die Markdown-Dateien durch jemand anderen oder einen frischen Agenten. Die Skills liegen in .claude/skills/; fehlt eins davon, prüfen wir den Pull Request nicht (docs/mitwirken.md, Beiträge annehmen).

Was bei jeder Meldung zu tun ist: Wenn eine Prüfung anschlägt. Agenten arbeiten sie nach Skill beitrag, Schritt 6, ab.

Stand 1125092. Dieser Kommentar ändert sich mit jedem Push.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant